<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<!-- Copyright 1997 The Open Group, All Rights Reserved -->
<title>uustat</title>
</head><body bgcolor=white>
<center>
<font size=2>
The Single UNIX &reg; Specification, Version 2<br>
Copyright &copy; 1997 The Open Group

</font></center><hr size=2 noshade>
<h4><a name = "tag_001_014_2733">&nbsp;</a>NAME</h4><blockquote>
uustat - uucp status inquiry and job control
</blockquote><h4><a name = "tag_001_014_2734">&nbsp;</a>SYNOPSIS</h4><blockquote>
<pre><code>

uustat <b>[</b> -q| -k <i>jobid</i>| -r <i>jobid</i><b>]</b>

uustat <b>[</b>-s <i>system</i><b>][</b>-u <i>user</i><b>]</b>
</code>
</pre>
</blockquote><h4><a name = "tag_001_014_2735">&nbsp;</a>DESCRIPTION</h4><blockquote>
The
<i>uustat</i>
utility displays the status of, or cancels, previously specified
<i><a href="uucp.html">uucp</a></i>
requests, or provides general status on
<i><a href="uucp.html">uucp</a></i>
connections to other systems.
<p>
When no options are given,
<i>uustat</i>
writes to standard output the status of all
<i><a href="uucp.html">uucp</a></i>
requests issued by the current user.
<p>
Typical implementations of this utility require a communications
line configured to use the <b>XBD</b> specification, <a href="../xbd/termios.html"><b>General Terminal Interface</b>&nbsp;</a> ,
but other communications means may be used.
On systems where there are no available communications means
(either temporarily or permanently), this
utility will write an error message describing the problem
and exit with a non-zero exit status.
</blockquote><h4><a name = "tag_001_014_2736">&nbsp;</a>OPTIONS</h4><blockquote>
The
<i>uustat</i>
utility supports the <b>XBD</b> specification, <a href="../xbd/utilconv.html#usg"><b>Utility Syntax Guidelines</b>&nbsp;</a> .
The following options are supported:
<p>
<dl compact>

<dt><b>-q</b>
<dd>Write the jobs queued for each machine.

<dt><b>-k&nbsp;</b><i>jobid</i>
<dd>
Kill the
<i><a href="uucp.html">uucp</a></i>
request whose job identification is
<i>jobid</i>.
The killed
<i><a href="uucp.html">uucp</a></i>
request must belong to the person invoking
<i>uustat</i>
unless that user has appropriate privileges.

<dt><b>-r&nbsp;</b><i>jobid</i>
<dd>Rejuvenate
<i>jobid</i>.
The files associated with
<i>jobid</i>
are touched so that
their modification time is set to the current time.
This prevents the cleanup program
from deleting the job until the jobs modification
time reaches the limit imposed by the program.

<dt><b>-s&nbsp;</b><i>system</i>
<dd>
Write the status of all
<i><a href="uucp.html">uucp</a></i>
requests for remote system
<i>system</i>.

<dt><b>-u&nbsp;</b><i>user</i>
<dd>Write the status of all
<i><a href="uucp.html">uucp</a></i>
requests issued by
<i>user</i>.

</dl>
</blockquote><h4><a name = "tag_001_014_2737">&nbsp;</a>OPERANDS</h4><blockquote>
None.
</blockquote><h4><a name = "tag_001_014_2738">&nbsp;</a>STDIN</h4><blockquote>
Not used.
</blockquote><h4><a name = "tag_001_014_2739">&nbsp;</a>INPUT FILES</h4><blockquote>
None.
</blockquote><h4><a name = "tag_001_014_2740">&nbsp;</a>ENVIRONMENT VARIABLES</h4><blockquote>
The following environment variables affect the execution of
<i>uustat</i>:
<dl compact>

<dt><i>LANG</i><dd>Provide a default value for the internationalisation variables
that are unset or null.
If
<i>LANG</i>
is unset or null, the corresponding value from the
implementation-dependent default locale will be used.
If any of the internationalisation variables contains an invalid setting, the
utility will behave as if none of the variables had been defined.

<dt><i>LC_ALL</i><dd>
If set to a non-empty string value,
override the values of all the other internationalisation variables.

<dt><i>LC_CTYPE</i><dd>
Determine the
locale for the interpretation of sequences of bytes of text data as
characters (for example, single- as opposed to multi-byte characters
in arguments).


<dt><i>LC_MESSAGES</i><dd>
Determine the locale that should be used to affect
the format and contents of diagnostic
messages written to standard error,
and informative messages written to standard output.

<dt><i>LC_TIME</i><dd>
Determine the format of date and time strings output by
<i>uustat</i>.

<dt><i>NLSPATH</i><dd>
Determine the location of message catalogues
for the processing of
<i>LC_MESSAGES .
</i>
<dt><i>TZ</i><dd>Determine the timezone used with date and time strings.

</dl>
</blockquote><h4><a name = "tag_001_014_2741">&nbsp;</a>ASYNCHRONOUS EVENTS</h4><blockquote>
Default.
</blockquote><h4><a name = "tag_001_014_2742">&nbsp;</a>STDOUT</h4><blockquote>
The standard output consists of information
about each job selected,
in an unspecified format.
The information will include at least the job ID,
the user ID or name and the remote system name.
</blockquote><h4><a name = "tag_001_014_2743">&nbsp;</a>STDERR</h4><blockquote>
Used only for diagnostic messages.
</blockquote><h4><a name = "tag_001_014_2744">&nbsp;</a>OUTPUT FILES</h4><blockquote>
None.
</blockquote><h4><a name = "tag_001_014_2745">&nbsp;</a>EXTENDED DESCRIPTION</h4><blockquote>
None.
</blockquote><h4><a name = "tag_001_014_2746">&nbsp;</a>EXIT STATUS</h4><blockquote>
The following exit values are returned:
<dl compact>

<dt>0<dd>Successful completion.

<dt>&gt;0<dd>An error occurred.

</dl>
</blockquote><h4><a name = "tag_001_014_2747">&nbsp;</a>CONSEQUENCES OF ERRORS</h4><blockquote>
Default.
</blockquote><h4><a name = "tag_001_014_2748">&nbsp;</a>APPLICATION USAGE</h4><blockquote>
None.
</blockquote><h4><a name = "tag_001_014_2749">&nbsp;</a>EXAMPLES</h4><blockquote>
None.
</blockquote><h4><a name = "tag_001_014_2750">&nbsp;</a>FUTURE DIRECTIONS</h4><blockquote>
None.
</blockquote><h4><a name = "tag_001_014_2751">&nbsp;</a>SEE ALSO</h4><blockquote>
<i><a href="uucp.html">uucp</a></i>.
<br>
</blockquote><hr size=2 noshade>
<center><font size=2>
UNIX &reg; is a registered Trademark of The Open Group.<br>
Copyright &copy; 1997 The Open Group
<br> [ <a href="../index.html">Main Index</a> | <a href="../xshix.html">XSH</a> | <a href="../xcuix.html">XCU</a> | <a href="../xbdix.html">XBD</a> | <a href="../cursesix.html">XCURSES</a> | <a href="../xnsix.html">XNS</a> ]

</font></center><hr size=2 noshade>
</body></html>
